SetCPixel

SetCPixel
Header:	Quickdraw.h		Carbon status:	Supported

Sets the color of an individual pixel to the color that most closely matches the RGB color that you specify in the cPix parameter.

void SetCPixel (
    SInt16 h, 
    SInt16 v, 
    const RGBColor *cPix
);

Parameter descriptions

h: The horizontal coordinate of the point at the upper-left corner of the pixel.
v: The vertical coordinate of the point at the upper-left corner of the pixel.
cPix: An RGBColor structure.

DISCUSSION

On an indexed color system, the SetCPixel function sets the pixel value to the index of the best-matching color in the current device’s CLUT. In a direct environment, the SetCPixel function sets the pixel value to a 16-bit or 32-bit direct pixel value.

To determine the color of an individual pixel, use the GetCPixel function.

SPECIAL CONSIDERATIONS

The SetCPixel function may move or purge memory blocks in the application heap; do not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.